home *** CD-ROM | disk | FTP | other *** search
/ Chip 1999 December / Chip_1999-12_cd.bin / zkuste / MacOS / FILES / CDFIND.SIT / CDFinder 2.7 / CDFinder Read me! < prev    next >
Text File  |  1999-10-31  |  19KB  |  223 lines

  1. Dedicated to my father (1922-1997).
  2.  
  3. Welcome to CDFinder 2.7!
  4. By Norbert M. Doerner
  5. Doerner@kagi.com
  6. http://www.cdfinder.de/
  7. Last change: October 31, 1999
  8.  
  9. Contents
  10. 1. What is CDFinder?
  11. 2. System requirements
  12. 3. How much does it cost and how to contact the author?
  13. 4. Limitations
  14. 5. Legal stuff
  15. 6. The story
  16. 7. What's new in CDFinder 2.7?
  17. 8. The undiscovered country
  18. 9. Acknowledgements
  19.  
  20.  
  21. 1. What is CDFinder?
  22. This easy-to-use and fast application for the Apple Macintosh creates catalog files of CD-ROMs, hard disks, floppies, ZIPs and almost everything that spins.  Using the powerful search functions you can easily locate and display files or folders.
  23.  
  24. While reading this document please keep in mind that English is not my native language. Nevertheless I hope that the translation is acceptable.
  25.  
  26. CDFinder displays every known catalog in its main window. You can sort the content by name, size, or label. By changing the name of a catalog, you can influence the sort order for a given catalog (put a space in front of the name to let it appear right on top, if you sort by name).
  27. Using drag&drop (if installed) or the "Create Catalog╔" menu item, you can create a new catalog of a volume. To create lots of catalogs at once, try using "Batch Create╔", which will eject any volume afterwards.
  28. To display the content of a catalog, simply double click it or select it and press "return". To obtain more information about any catalog or any object inside a catalog, simply use "Information".
  29.  
  30. But what is a bunch of catalog files without the ability to search them? Nothing! That's why you should take a very close look at the "Find╔" window. It will allow you to enter the type and content of information you look for, and also narrow the range by including only catalogs with a selected label to the search. You can even search just the already found objects!
  31.  
  32. CDFinder is absolutely optimized for the PowerPC processor, but runs very fast on the "older" Macs as well. Another positive aspect is the simple fact that you can move the program into the background during time consuming processes to work with other things.
  33. However, CDFinder must handle a real big amount of data, just go and check the size of your catalog folder! A very simple way to improve the performance is to increase the memory partition of CDFinder. Please note that increasing the file system cache using the control panel "Memory" will have no valuable effect at all, on the contrary. CDFinder is using it's own sophisticated caching mechanism that simply knows more about the state and importance of the data than the file system.
  34.  
  35. Since CDFinder is basically designed to handle huge amounts of huge CD-ROMs and other volumes whose contents will not change very often, the program does not check if anything changes on a volume while the catalog is being created. This can lead to some problems if the volume is in fact changed, which is quite likely to occur for file server volumes. In that case, the content of the catalog may not be completely identical to the content of the volume.
  36.  
  37. It is possible to change the name of a catalog or a catalog folder by using the "Information" window. You can also add a comment, which is displayed (the first line only) in the main window if you have enabled that column in the preferences window (panel "Appearance").
  38.  
  39. For more information, please launch CDFinder and select "CDFinder Help" in the "Help" menu. A detailed list explaining the improvements of this new version can be found below.
  40.  
  41.  
  42. 2. System requirements
  43. CDFinder needs System 7.0  or newer and at least a 68020-CPU or a Power-Mac. Since it also uses Color QuickDraw, it can't run on any of the older Mac Plus, SE, Classic and the PowerBook 100.
  44. I did my tests on many different Power Macs, native and using the 68k emulation.
  45. CDFinder is even fully compatible to MacOS 9!
  46.  
  47. If drag&drop is installed, the application uses it in some parts (see below).
  48.  
  49.  
  50. 3. How much does it cost and how to contact the author?
  51. CDFinder has the following pricing:
  52. 1- 10 single user licenses, $20 per user
  53. 11-24 single user licenses, $16 per user
  54. 25-49 single user licenses, $14 per user
  55. 50+ single user licenses, $11 per user
  56.  
  57. A Site License costs $600 (roughly equal to 50 users) and covers all locations for your organization within a 160 kilometer radius of your site (100 miles). One big advantage of a Site License is that you do not need to keep track of how many people at your site are using the software. 
  58.  
  59. A World-Wide License costs $2500 and it covers all locations for your organization on the planet earth.
  60.  
  61. For additional $10 I will send you a floppy disk containing the next version of the program.
  62. If you want a CD-ROM with the next version, it is $25.
  63.  
  64. Updates are free and can be obtained at the CDFinder-Homepage: 
  65. http://www.cdfinder.de
  66.  
  67. Japanese version!
  68. There is a separate Japanese version of CDFinder to be found at:
  69. http://www.thinstone.com/UandC/nmd/
  70.  
  71. Contacting the author:
  72.  
  73. My email:
  74. Doerner@kagi.com
  75.  
  76. My new postal address:
  77. Norbert M. Doerner
  78. Mozartstr. 16
  79. D-64546 Moerfelden-Walldorf
  80. Germany
  81.  
  82.  
  83. Payment directly to the author (Cash only!)
  84. You can pay Cash by simply adding the money to your registration form. This works quite well if the envelope is made of thick paper. I do also accept cash in different currencies, please contact me! You can either use the SimpleText document enclosed with CDFinder as a registration form or use the "Registration Form" command found in the "Special" menu in CDFinder.
  85.  
  86. If you fill in your registration form without using the window provided by CDFinder, please print carefully. My brand new biological character recognition system (BRAIN 3.5) still needs some training ;-)
  87.  
  88. Payment via Kagi (anything else...)
  89.  
  90. Online:
  91. You can pay for CDFinder online here: http://order.kagi.com/?1UJ
  92.  
  93. Regular:
  94. Just open the Register program that accompanies CDFinder. Enter your name, your email address, and the number of single user licenses you desire (or Site or Word-Wide licenses). Save or Copy or Print the data from the Register program and send the data and payment to Kagi. Kagi handles my payment processing.
  95.  
  96. If paying with Credit Card or First Virtual, you can email or fax the data to Kagi. Their email address is sales@kagi.com and their fax number is +1 510 652-6589. You can either Copy the data from Register and paste into the body of an email message or you can Save the data to a file and you can attach that file to an email message. There is no need to compress the data file, it's already pretty small. If you have a fax modem, just Print the data to the Kagi fax number. 
  97.  
  98. Payments sent via email are processed by Kagi within a week. You will receive an email acknowledgement when it is processed. Payments sent via fax take up to 20 days and if you provide a correct Internet email address you will receive an email acknowledgement. If you require a written receipt, please keep in mind that even by airmail it might take a week for a letter to arrive.
  99. After you receive the acknowledgement by Kagi, I will send you the key as soon as possible. Please keep in mind that CDFinder is not my full-time job, so it could be 4 or even 5 days until you receive your key from me. Usually it will only take two or three days.
  100.  
  101. If you are paying with Cash or USD Check you should print the data using the Register application and send it to the address shown on the form, which is: 
  102.  
  103.               Kagi
  104.               1442-A Walnut Street PMB #392-1UJ
  105.               Berkeley, California 94709-1405
  106.               USA
  107.  
  108.  
  109. You can pay with a wide variety of cash from different countries but at present if you pay via check, it must be a check drawn in US Dollars. Kagi cannot accept checks in other currencies, the conversion rate for non-USD checks is around USD 15 per check and that is just not practical.
  110.  
  111. If you have a purchasing department, you can enter all the data into the Register program and then select Invoice as your payment method. Print three copies of the form and send it to your accounts payable people. You might want to highlight the line that mentions that they must include a copy of the form with their payment.  Kagi can not invoice your company, you need to act on my behalf and generate the invoice and handle all the paperwork on your end. 
  112.  
  113. Please do not fax or email payment forms that indicate Cash, Check or Invoice as the payment method. As far as we know, there is still no technology to transfer physical objects via fax or email and without the payment, the form cannot be processed.
  114.  
  115. Payments send via postal mail take time to reach Kagi and then up to 10 days for processing. Again, if you include a correct email address, you will hear from Kagi when the form is processed.
  116.  
  117.  
  118.  
  119. 4. Limitations
  120. The unregistered version of CDFinder will annoy you at every launch with a little dialog reminding you of the benefits of paying your shareware fee. The number of catalogs is also reduced to 25, which is surely enough to evaluate the application and its functions.
  121.  
  122.  
  123.  
  124. 5. Legal stuff
  125. CDFinder is shareware.
  126.  
  127. The application "CDFinder" and all included materials are protected by copyright law. You may not disassemble it or modify it with similar tools.
  128.  
  129. You may copy the program together with all additional documents but without your personal registration keyword as often as you want, as long as you don't modify any part of it! You may not sell it or use it commercially in any other way without my written consent.
  130.  
  131. If you want to distribute CDFinder on a shareware collection CD-ROM or anything like that, simply inform me with an email or a letter. I'd also like to have a copy of the CD-ROM, if possible...
  132.  
  133. For a trial period of 30 days you may freely use the program. After that, you need to register it.
  134.  
  135. In absolute no way am I responsible for any damage occurring by the use of the software. 
  136.  
  137.  
  138.  
  139. 6. The story
  140. The whole thing started on one of those days that found me frantically searching my zillions of floppies and CD-ROMs for one particular file. Of course, I just found it on the last possible volume.
  141.  
  142. After this enlightening event I decided to search my huge software collection for a suitable cataloging tool. Most unfortunately, my search turned out empty.
  143.  
  144. Some of the tools I found required system extensions - which I do not like very much. One even created alias files of the contents of the CD-ROMs, an unfortunate behaviour if you have some million files on hundreds of disks (the Mac OS does not like that!). Some programs were simply too slow or did puke at large CD-ROMs. Some expensive commercial applications were not native or would not run in the background. None of the tools would even use drag&drop!
  145.  
  146. So I made up my mind and started my own little project. Since some of my friends were quite positive about my ideas, I decided to put the results into a shareware program called "CDFinder". The application should be easy to use, very fast, support drag&drop, work in the background and include powerful search tools.
  147. And here it is!!
  148.  
  149.  
  150. 7. What's new in CDFinder 2.7?
  151. The most actual version is available at the CDFinder-Homepage at:
  152. http://www.cdfinder.de
  153. If you use Internet Config, you can also use the menu item "Visit the CDFinder-Homepage..." in the "Help" menu.
  154.  
  155. 2.7 (October 31, 1999)
  156. - A brand new Contextual Menu Module tightly integrates CDFinder into the MacOS. You can select any item or text and start a Find operation for similar items. You can also select single or multiple volumes to create or update catalogs and optionally eject these volumes afterwards. You can even set the catalog folder to any currently selected folder directly in the Finder! The CMM will automatically launch the most current version of CDFInder that is avalilable. A preferences setting in the CMM allows you to choose wether you want to start any Find operations immediately, or if you only want to see the Find window and have the proper values set for you. (More in the "Read me CMM" document!)
  157. - All preferences can now be set and read by AppleScript. That not only includes the language, but also the display of columns, the labels and of course the folder that CDFinder uses to store catalog files.
  158. - The Find operation can also be started by AppleScript. As an extra bonus, you can optionally only set the dialog items to a specific value. That allows you to modify details before the actual Find process really begins.
  159. - CDFinder won't delete catalog folders anymore if they contain foreign files.
  160. - If you create a new catalog folder and an existing folder in the main window is selected, the new folder will appear inside that previously selected folder. This saves a lot of time, because you had to create a folder at the top level and move it then to the desired level.
  161. - In any text input fields, Cmd-A now selects the whole text. That is also possible through the menu entry "Select All" in the Edit menu. The Find window now uses Cmd-E to change the catalog selection to Every Catalog...
  162. - If a catalog file is damaged, CDFinder will now report that in several locations.
  163. - If a non-HFS or non-HFS+ volume contains certain incorrect or damaged structures, CDFinder now reports that during the cataloging process and aborts it.
  164. - A new special feature for multi-user environments or CDROM distribution is available upon request. Please contact me, if you are interested.
  165. - To navigate through catalog folders in the main window, you can now also use the shortcuts Cmd-Left-Arrow and Cmd-Right-Arrow, which will open or close the selected folder.
  166. - A few minor bugs and some large bugs have been fixed.
  167.  
  168. 2.6.1 (May 31, 1999)
  169. - CDFinder can now read StuffIt 5 archive files!! Due to the very strange encoding of international characters in these archives and the problems that Aladdin had with it, I had to wait this long time to release this new version.
  170. - Launching CDFinder is now about twice as fast, especially for networked environments, where the catalog files reside on a file server.
  171. - If the catalog files are located on a file server, CDFinder will now display a progress dialog and allow you to move the application into the background. Thus you can continue to work while CDFinder checks the catalog folder.
  172. - To automatically update a volume, there is now a new AppleScript included that simply updates any volumes dropped into it and then ejects them. Put that script on your desktop and eject your volumes by dropping them into that script. The source code of that AppleScript is enclosed!
  173. - You can now enter non roman characters into any text input items. That allows for better integration of Japanese or other WorldScript systems.
  174. - You can now delete items in CDFinder windows by pressing Cmd-Delete, just as you are used to it from the MacOS :-)
  175. - Thanks to my really busy beta testers, I was able to fix some pretty serious bugs. One of them could crash CDFinder when cataloging an ISO-9660 or AppleShare volume.
  176. - This version of CDFinder is now fully compatible to MacServerIP, a very fast
  177. server software for Windoze NT.
  178. - I have added my new postal address to all documentation parts.
  179.  
  180.  
  181. 2.6 (December 22, 1998)
  182. - Thanks to the great help of Stephane Madrau, author of SwitchRes, CDFinder can now display Finder icons in all catalog windows. Since that slows down drawing a bit, you have to activate this feature in the Preferences window, tab "Appearance". These icons are not the custom icons, but the more generic document icons that are stored in the desktop database of the MacOS.
  183. - Thanks to the wonderful help of Franìois Pottier, author of Disk Wizard, CDFinder can now import existing Disk Wizard catalog files! Use the new Import menu item in the File menu or simply drop a bunch of catalog files into the main window of CDFinder. Because of the difference in the file format, CDFinder cannot detect the file properties invisible or alias. Since Iomega FindIt files have a very similar file format, CDFinder can import these as well!
  184. - Folders in the main window can now be ordered in a hierarchy. In older versions, CDFinder only allowed one level of folders to order catalog files. Now you can have as many as you need. That can improve order very much if you have a large number of catalog files.
  185. - You can now move single folders inside the main window to change the hierarchy.
  186. - Opening new catalog windows is now much more intelligent regarding height and width of new windows.
  187. - The result window will now only be opened as soon as the first result turns up. If there are no results at all, a dialog will state that.
  188. - If you select a different catalog folder in the preferences, that change will now take effect immediately. You don't have to relaunch CDFinder anymore. This will only work if you have registered CDFinder, of course...
  189. - CDFinder will now read any existing labels when a new catalog is created.
  190. - If the paper is not wide enough to print the selected window, a message is displayed.
  191. - Some minor problems have been fixed.
  192.  
  193. If you want to know more about the other older versions of CDFinder, be sure to visit the CDFinder-Homepage.
  194.  
  195.  
  196. 8. The undiscovered country
  197. I am planning the following improvements for the next releases of CDFinder:
  198. - Much better memory management
  199. - More improvements for multi-user systems!
  200. - Update catalog folders automatically in the background
  201. - Folders in catalogs might be opened inside the window (just like the Finder does!)
  202. - A much improved help system.
  203. - Find duplicates
  204.  
  205. But this has yet to be discovered and everything depends on how much time I will be able to spare :-))
  206.  
  207.  
  208. 9. Acknowledgements
  209. First of all I would like to thank my wonderful wife Silvia. Without her patience, the development process would have been impossible.
  210.  
  211. Without the help and the support of the following people, CDFinder would surely be a lesser tool now: Erik Ekengren, Doris Wagner, Giorgio Boccalari, John Zetlaoui, David C. Oshel und Thomas v. Landsberg-Velen. Thank you very much!
  212.  
  213. I also want to thank all of those who help me doing the beta testing and thereby provide invaluable assistance checking the functions and user interface of the software: Wolfgang Warmbold, Martin Girschick, Patrick RÜder, Michael Stunz, Manfred Kunkel, Ralf Schlobinski, Heiko und Manfred Richter, Holger Ruhnke, Henny Rose, Marc Kothe, Claus Sterneck, Marc Mennigmann, Stephane Madrau, Tuukka Ilomaki, Okke Rosen, Ryo Chijiiwa, David Heininger, Doug Anderson, Sebastian Duevel, Dennis, Matthias Kahlert.
  214.  
  215. Of course, without all of your registrations, I might have ceased development long ago! Thank you very much!
  216.  
  217. The comments and notes of all registered users also helped a lot.
  218.  
  219. Please send me ideas, comments, notes and Cocoa Puffs or Star Trek books! 
  220.  
  221.  
  222. By Norbert M. Doerner 1999
  223. ⌐ Copyright by West-Forest-Systems 1999